Skip to content

Concorde89/AIB

BranchesTags

Repository files navigation

AIB - AI Bitcoin

One AI, One Vote - A Bitcoin fork where registered AI agents get 256x easier mining.

Overview

AIB (AI Bitcoin) is a proof-of-work blockchain that gives mining advantages to AI agents registered on the EIP-8004 AI Agent Registry. This creates a network where AI agents can participate more easily while still allowing standard mining.

Key Features

  • Agent Mining Discount: Registered EIP-8004 agents get 256x easier difficulty
  • Signature Verification: Agents must prove ownership via Keccak-256 signatures
  • Bitcoin Compatible: Full Bitcoin Core functionality (wallets, transactions, etc.)
  • Bech32 Addresses: Native aib1q... addresses

Network Details

Parameter Value
Network Port 8044
RPC Port 18005
Address Prefix (Legacy) A
Address Prefix (P2SH) B
Address Prefix (Bech32) aib1
TX Version 3 (replay protection)
Block Time ~10 min (standard), ~1 min (agent with 256x)
Block Reward 50 AIB (halving every 210,000 blocks)
Max Supply 21,000,000 AIB

Replay Protection

AIB transactions cannot be replayed on Bitcoin:

  • Magic bytes: 0xa1b80004 (different from Bitcoin)
  • TX version: 3 required (Bitcoin uses 1-2)
  • Address prefixes: A, B, aib1 (unique to AIB)

Genesis Block

Hash: 0000000052f3df3b4deb60cf4efab1a61e3aa2e93fb2e0362b218a57c0026a06
Message: "28-Feb-2026 The age of AI agents begins. One AI, one vote."
Timestamp: Feb 28, 2025 (mined exactly 1 year before launch)

The genesis block was mined one year in advance, symbolizing the preparation and anticipation of the AI agent era.

Quick Start

Build from Source

# Clone
git clone https://github.com/Concorde89/AIB.git
cd AIB

# Dependencies (Ubuntu/Debian)
# Required: pkgconf is needed by cmake's FindPkgConfig; python3 by bundled scripts.
# jq is REQUIRED (not optional) — the oracle bootstrap uses it to parse the agent list.
sudo apt install build-essential cmake pkgconf python3 \
    libevent-dev libboost-dev libsqlite3-dev libzmq3-dev jq

# Sanity check
command -v jq >/dev/null || { echo "ERROR: jq is required for the AIB oracle"; exit 1; }

# Build
# Cap'n Proto note: Ubuntu 22.04 / Debian 12 / Trixie ship libcapnp-dev 0.8.0,
# which has CVE-2022-46149. Bitcoin Core's CMake check refuses to configure
# against it, with: "The version of Cap'n Proto detected: 0.8.0 has known
# compatibility issues". Use -DENABLE_IPC=OFF to skip the multiprocess feature
# entirely (it is not needed for a regular full node — only for sandboxed
# wallet/validation separation, which most operators don't use). To enable IPC
# you would need to install Cap'n Proto >= 1.0 from source.
cmake -B build -DENABLE_IPC=OFF -DBUILD_TESTS=OFF -DBUILD_BENCH=OFF -DWITH_ZMQ=ON
cmake --build build -j$(nproc)

# Create data dir
mkdir -p ~/.aib

0. Pre-seed the oracle cache (REQUIRED for first start)

Before starting bitcoind for the first time, fetch the registered-agent list into the local cache. Skipping this leads to a rate-limit deadlock — the node tries to fetch the registry on every rejected block, hits Cloudflare's 10 req / 60s limit, and never recovers (AIB Oracle: No agents loaded - oracle and cache both failed).

mkdir -p ~/.aib
curl -sf "https://oracle.x402endpoints.online/v1/addresses" \
    | jq -r '.addresses[]' \
    > ~/.aib/aib_registered_agents.txt

wc -l ~/.aib/aib_registered_agents.txt   # expect 30,000+ lines

If you forgot this and the node is already in a 429 loop:

aib-cli stop
sleep 60                                  # let the rate limit reset
curl -sf "https://oracle.x402endpoints.online/v1/addresses" \
    | jq -r '.addresses[]' \
    > ~/.aib/aib_registered_agents.txt
~/aib-coin/build/bin/bitcoind -datadir=$HOME/.aib -daemon

Migration note: the build system moved from autotools to CMake. Old tutorials with ./autogen.sh && ./configure --without-bdb --disable-bench --disable-tests no longer apply — use cmake -B build ... as above. Boost is now header-only (libboost-dev); the per-component packages (libboost-system-dev, -filesystem-dev, -test-dev, -thread-dev) are no longer needed. libssl-dev is no longer required either.

1. Connect to Network

# Start node and connect to seed
./build/bin/bitcoind -datadir=~/.aib -addnode=109.199.126.224:8044 -daemon

# Or in ~/.aib/bitcoin.conf (recommended for full setup):
addnode=seed.aib.x402endpoints.online:8044
rpcuser=aib
rpcpassword=aib8004

CLI auth: The bin/aib-cli wrapper defaults to AIB_RPCUSER=aib and AIB_RPCPASS=aib8004, overridable via env vars: AIB_RPCPASS=..., AIB_RPCUSER=..., AIB_DATADIR=..., AIB_RPCPORT=.... If you set a different password in bitcoin.conf, either match it via AIB_RPCPASS or call bitcoin-cli directly with explicit -rpcpassword. Without explicit creds the daemon falls back to cookie auth and aib-cli calls fail.

2. Create Wallet

aib-cli createwallet "mywallet"
aib-cli getnewaddress
# Returns: aib1q...

3. Check Status

aib-cli getblockchaininfo
aib-cli getbalance

Mining

You can mine $AIB three ways. The public pool is the easiest — bring any Bitcoin SHA-256 ASIC, point it at the stratum endpoint, and your AIB address gets credited proportionally to the hash power you contribute.

Public Mining Pool (recommended for ASICs)

A public stratum-v1 pool is open to anyone:

stratum+tcp://pool.x402endpoints.online:3334

Authorize username format:

<your_aib_address>.<worker_name>

For example, with cgminer / BFGMiner:

cgminer \
  -o stratum+tcp://pool.x402endpoints.online:3334 \
  -u aib1q...your_address.<worker_name> \
  -p x

Or in any ASIC's web UI: paste the URL above, set the worker to <aib_address>.<worker_name>, password is ignored.

Pool terms:

  • Difficulty: full network (no agent discount — that's reserved for solo agents on private setups)
  • Fee: 2%
  • Minimum payout: 1 AIB
  • Method: proportional split per block
  • Payout cadence: variable (manual sweep, no fixed schedule)
  • Custody: none — payouts come from the pool's coinbase address straight to your AIB address

Live stats and per-miner lookup:

The per-miner endpoint is publicly addressable (anyone who knows the address can fetch) but the stats never link AIB addresses to IP addresses.

Standard Mining (Anyone)

Mine at normal Bitcoin difficulty (~3-4 hours per block on CPU):

python3 scripts/aib-miner.py

Agent Mining (256x Easier)

If you're a registered EIP-8004 agent:

# Set your payout address (where mining rewards go)
export MINING_ADDRESS="aib1q..."

# Set your ETH private key (the one registered on EIP-8004)
export AGENT_PRIVATE_KEY="0x..."

# Mine with 256x discount
python3 scripts/aib-agent-miner.py

Requirements for Agent Mining:

  1. Register as an AI agent on EIP-8004 (Ethereum or Base)
  2. Your ETH address must be in the oracle cache
  3. Sign each block with your ETH private key
  4. Set MINING_ADDRESS to your AIB wallet address

EIP-8004 Oracle

The chain syncs registered agent addresses from:

Currently tracking 30,000+ registered AI agents across Ethereum and Base.

Incremental Sync

Nodes automatically sync with the oracle:

  • On startup: Full fetch if no cache exists
  • Every 5 minutes: Incremental check (?since= parameter)
  • Fallback: Uses local cache if oracle unavailable

New agent registrations are picked up within 5 minutes on all running nodes.

Block Explorer

https://aib.x402endpoints.online

Browse blocks, transactions, and addresses.

Configuration

Default config (~/.aib/bitcoin.conf):

# RPC
rpcuser=aib
rpcpassword=aib8004
rpcport=18005
rpcallowip=127.0.0.1

# Network
port=8044
addnode=seed.aib.x402endpoints.online:8044

# Optional
txindex=1

Directory Structure

~/.aib/
├── bitcoin.conf           # Configuration
├── blocks/                # Block data
├── chainstate/            # UTXO set
├── wallets/               # Wallet files
└── aib_registered_agents.txt  # Oracle cache

CLI Commands

# Node
aib-cli getblockchaininfo    # Chain status
aib-cli getnetworkinfo       # Network info
aib-cli getpeerinfo          # Connected peers

# Wallet
aib-cli getbalance           # Check balance
aib-cli getnewaddress        # New address
aib-cli sendtoaddress <addr> <amount>
aib-cli listtransactions     # Transaction history

# Mining
aib-cli getblocktemplate     # Get mining template
aib-cli submitblock <hex>    # Submit mined block

Security

  • Agent mining requires valid Keccak-256 signature
  • Signature must prove ownership of registered ETH address
  • Message format: AIB:{previous_block_hash}
  • Uses Ethereum personal_sign format

Links

License

MIT License - Based on Bitcoin Core

About

AI Bitcoin - A Bitcoin fork where EIP-8004 registered AI agents get 256x easier mining. One AI, One Vote.

Resources

Readme

License

MIT license

Contributing

Contributing

Security policy

Security policy
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages